package com.common.dingding.common;

import lombok.Data;

import java.io.Serializable;
import java.util.HashMap;
import java.util.Map;

/**
 * 通用响应结果类
 * 用于统一API接口返回格式
 */
@Data
public class Result<T> implements Serializable {
    private static final long serialVersionUID = 1L;

    /**
     * 响应状态码：true-成功，false-失败
     */
    private boolean success;

    /**
     * 响应消息
     */
    private String message;

    /**
     * 响应数据
     */
    private T data;

    /**
     * 扩展字段，用于存储额外信息
     */
    private Map<String, Object> extra = new HashMap<>();

    /**
     * 私有构造方法
     */
    private Result() {
    }

    /**
     * 创建成功响应
     * @param <T> 数据类型
     * @return 成功响应对象
     */
    public static <T> Result<T> success() {
        Result<T> result = new Result<>();
        result.setSuccess(true);
        result.setMessage("操作成功");
        return result;
    }

    /**
     * 创建成功响应
     * @param data 响应数据
     * @param <T> 数据类型
     * @return 成功响应对象
     */
    public static <T> Result<T> success(T data) {
        Result<T> result = success();
        result.setData(data);
        return result;
    }

    /**
     * 创建成功响应
     * @param data 响应数据
     * @param message 响应消息
     * @param <T> 数据类型
     * @return 成功响应对象
     */
    public static <T> Result<T> success(T data, String message) {
        Result<T> result = success(data);
        result.setMessage(message);
        return result;
    }

    /**
     * 创建失败响应
     * @param message 错误消息
     * @param <T> 数据类型
     * @return 失败响应对象
     */
    public static <T> Result<T> fail(String message) {
        Result<T> result = new Result<>();
        result.setSuccess(false);
        result.setMessage(message);
        return result;
    }

    /**
     * 设置扩展字段
     * @param key 字段名
     * @param value 字段值
     * @return 当前响应对象
     */
    public Result<T> putExtra(String key, Object value) {
        this.extra.put(key, value);
        return this;
    }

    /**
     * 设置响应消息
     * @param message 响应消息
     * @return 当前响应对象
     */
    public Result<T> message(String message) {
        this.setMessage(message);
        return this;
    }
}